Manage orders - Gets a list of product promotions.
파트너의 사용 가능한 프로모션을 가져옵니다.
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions?country={country}&segment={segment}
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
version
|
path | True |
string |
|
|
country
|
query |
string |
국가입니다. |
|
|
segment
|
query |
string |
세그먼트입니다. |
요청 헤더
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| Authorization | True |
string |
권한 부여 전달자 토큰 |
| ms-correlationid |
string |
내부적으로 요청을 추적하는 데 사용됩니다. ms-correlationid가 제공되지 않으면 서버는 각 요청에 대해 새 상관 관계를 생성합니다. |
|
| MS-CV |
string |
내부적으로 요청을 추적하는 데 사용됩니다. MS-CV 제공되지 않으면 서버는 각 요청에 대해 새 MS-CV 생성합니다. |
|
| ms-requestid |
string |
요청의 idempotency에 사용됩니다. ms-requestid가 제공되지 않으면 서버는 각 요청에 대해 새 요청을 생성합니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
요청이 성공했습니다. 응답 본문에는 파트너에 대한 프로모션 목록이 포함됩니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 400 Bad Request |
누락되었거나 잘못된 입력이 있었습니다. 응답 본문은 오류 세부 정보를 제공합니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
요청이 인증되지 않았습니다. 클라이언트는 먼저 파트너 API 서비스를 사용하여 인증해야 합니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
요청이 인증되었지만 호출자가 호출할 권한이 없으므로 거부되었습니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
리소스를 찾을 수 없거나 지정된 입력 매개 변수와 함께 사용할 수 없습니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
파트너 API 서비스 또는 해당 종속성 중 하나가 요청을 충족하지 못했습니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
정의
Contracts.V1.Models.ProductPromotion
| Name | 형식 | Description |
|---|---|---|
| description |
string |
|
| endDate |
string (date-time) |
|
| id |
string |
|
| name |
string |
|
| properties | ||
| requiredProducts | ||
| startDate |
string (date-time) |
Contracts.V1.Models.ProductPromotionPricingPolicy
| Name | 형식 | Description |
|---|---|---|
| policyType |
string |
|
| value |
string |
Contracts.V1.Models.ProductPromotionProperties
| Name | 형식 | Description |
|---|---|---|
| isAutoApplicable |
boolean |
Contracts.V1.Models.ProductPromotionRequiredProduct
| Name | 형식 | Description |
|---|---|---|
| pricingPolicies | ||
| productId |
string |
|
| skuId |
string |
|
| term |
Contracts.V1.Models.ProductPromotionTerm
| Name | 형식 | Description |
|---|---|---|
| billingCycle |
string |
|
| duration |
string |
Link
| Name | 형식 | Description |
|---|---|---|
| body |
string |
|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
ResourceAttributes
| Name | 형식 | Description |
|---|---|---|
| etag |
string |
|
| objectType |
string |
ResourceCollection[Contracts.V1.Models.ProductPromotion]
| Name | 형식 | Description |
|---|---|---|
| attributes | ||
| items | ||
| links | ||
| totalCount |
integer (int32) |
ResourceLinks
| Name | 형식 | Description |
|---|---|---|
| next | ||
| previous | ||
| self |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| Name | 형식 | Description |
|---|---|---|
| key |
string |
|
| value |
string |